This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@primer/brand-css@0.72.0

Minor Changes

• #1413 6288e69 Thanks @rezrah! - ⚠️ Breaking change to Hero.Image and Hero.Video ⚠️

  Previously combined padding and position semantics have been separated.

  The position prop will now only control layout and positioning relative to the content. It accepts block-end, inline-start, or inline-end.

  -<Hero.Image position="block-end-padded" src="image.jpg" alt="" />
  +<Hero.Image position="block-end" padding="all" src="image.jpg" alt="" />

• #1413 6288e69 Thanks @rezrah! - Added opt-in position and padding controls to River.Visual media in the gridline variant.

  🔗 Storybook examples:

  • Center position
  • Block-end position
  • Block-end inline-start position
  • Block-end inline-end position
  • No padding
  • Padding on all sides

@primer/brand-primitives@0.72.0

Minor Changes

• #1413 6288e69 Thanks @rezrah! - Added opt-in position and padding controls to River.Visual media in the gridline variant.

  🔗 Storybook examples:

  • Center position
  • Block-end position
  • Block-end inline-start position
  • Block-end inline-end position
  • No padding
  • Padding on all sides

Patch Changes

• #1412 6bf33b3 Thanks @danielguillan! - - Mapped the light and dark --brand-color-text-link-rest values to blue-6 and blue-1.
  • Updated the light --brand-color-canvas-muted value to #F9FBF9.

@primer/react-brand@0.72.0

Minor Changes

• #1401 bbbc4b3 Thanks @rezrah! - Multiple ActionMenu component updates:

  • Calls consumer-provided onClick handlers in default and split-button modes.
  • ⚠️ Breaking change to ActionMenu.Button in split-button mode. Custom HTML attributes are now correctly forwarded to the primary action instead of the menu toggle. This was the originally intended behavior.
  • Forwards the variant prop in default mode correctly. ActionMenu can now render in all available Button variants.
  • Forwards the leadingVisual prop in default mode.

• #1427 d104c0d Thanks @rezrah! - Removed the global block layout applied to img and picture elements to prevent overriding of default inline behavior.

  To minimize regressions, block has been applied to image elements at a component level instead.

  ⚠️ If you previously relied on the display: block styling from our reset.css, please apply it manually in your application code.

• #1413 6288e69 Thanks @rezrah! - ⚠️ Breaking change to Hero.Image and Hero.Video ⚠️

  Previously combined padding and position semantics have been separated.

  The position prop will now only control layout and positioning relative to the content. It accepts block-end, inline-start, or inline-end.

  -<Hero.Image position="block-end-padded" src="image.jpg" alt="" />
  +<Hero.Image position="block-end" padding="all" src="image.jpg" alt="" />

• #1365 808df8a Thanks @danielguillan! - ⚠️ Breaking change: Removed the imageBackgroundColor prop from River.Visual, RiverBreakout.Visual, and RiverBreakoutTabs.Visual.

  The River gridline variant now applies the full-bleed visual background layout by default. Remove imageBackgroundColor="subtle" from River.Visual when using the gridline variant.

  Remove imageBackgroundColor from RiverBreakout.Visual and RiverBreakoutTabs.Visual without replacement. Their default visual treatments are unchanged.

  The background treatment is not applied to the default River variant or either RiverBreakout variant.

  Updated the River gridline variant tablet layout with a 618px max-width and lateral gridlines.

• #1413 6288e69 Thanks @rezrah! - Added opt-in position and padding controls to River.Visual media in the gridline variant.

  🔗 Storybook examples:

  • Center position
  • Block-end position
  • Block-end inline-start position
  • Block-end inline-end position
  • No padding
  • Padding on all sides

• #1420 654b881 Thanks @danielguillan! - Exported useFocusTrap from the package root and created stable container and initial-focus refs when they are not provided.

Patch Changes

• #1427 d104c0d Thanks @rezrah! - Fixed the global reset so smooth scrolling is disabled consistently when users prefer reduced motion.

• #1417 1d59236 Thanks @stefankp! - Fixed missing styles for ESM form controls, where the dependent design tokens were missing . Affects TextInput, Textarea, Select, Checkbox, Radio, and FormControl.

• #1412 6bf33b3 Thanks @danielguillan! - - Mapped the light and dark --brand-color-text-link-rest values to blue-6 and blue-1.

  • Updated the light --brand-color-canvas-muted value to #F9FBF9.

• #1416 9b8ccce Thanks @danielguillan! - Fixed the Hero image border radius when rendering a picture element.

• #1413 6288e69 Thanks @rezrah! - Added Hero.ButtonGroup for rendering Button and ActionMenu children. Hero.ButtonGroup is now the de facto way to display buttons in the Hero.

  ⚠️ Hero.PrimaryAction and Hero.SecondaryAction are now deprecated. Please migrate over to Hero.ButtonGroup as they will be removed in a future release.

  Migrate using the following approach:

  -<Hero.PrimaryAction href="#">Primary action</Hero.PrimaryAction>
  -<Hero.SecondaryAction href="#">Secondary action</Hero.SecondaryAction>
  +<Hero.ButtonGroup>
  +  <Button as="a" href="#">
  +    Primary action
  +  </Button>
  +  <Button as="a" href="#">
  +    Secondary action
  +  </Button>
  +</Hero.ButtonGroup>

• #1411 3c89bdc Thanks @danielguillan! - Fixed NavList indentation across grouped nested disclosure levels.

• #1391 930ab18 Thanks @rezrah! - Added a labels prop to the Pagination component for customizing the user-facing labels of the previous and next controls.

  <Pagination
    pageCount={10}
    currentPage={2}
    labels={{prev: 'Précédent', next: 'Suivant', prevAriaLabel: 'Page précédente', nextAriaLabel: 'Page suivante'}}
  />

• #1365 808df8a Thanks @danielguillan! - Improve RiverAccordion gridline layout on tablet viewports and update its accordion toggle icon from chevrons to triangles.

• #1388 21c954b Thanks @danielguillan! - Removed the non-functional VideoPlayer showControlsWhenPaused prop from the public API and documentation.

• #1362 8433cf8 Thanks @danielguillan! - - Restored rounded corners to CTABanner while preserving square edges when grid lines are enabled.

  • Improved ButtonGroup to forward custom class names alongside its default styles.
  • Added native ActionMenu child support to ButtonGroup, including automatic sizes and positional variants, and the CTABanner.ButtonGroup wrapper.

• #1360 5cbb414 Thanks @danielguillan! - Updated SectionIntroStacked layout spacing for improved visual alignment.

@primer/brand-mcp@0.72.0

Patch Changes

• #1400 29cf9f0 Thanks @rezrah! - Improves guidance and examples delivered through the Primer Brand MCP tools:

  • Improves guidance delivered through the primer_brand_review tool.
  • Cleaner output from the primer_brand_examples tool.
  • Add new page design guidance advising that River descriptions are limited to 160 characters and the default 50:50 image-to-text ratio is preferred.
  • Improved guidance on imagery used in Hero and River components

@primer/brand-docs@0.72.0

@primer/brand-storybook@0.72.0

@primer/brand-e2e@0.72.0

@primer/brand-fonts@0.72.0

@primer/brand-config@0.72.0